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Abstract— 


language started out as a project aimed 


Quorum programming 
towards simplifying syntax to reduce 
complexity in writing codes. Over the years 
it has evolved and now it supports audio 
processing, basic game development, 
LEGO robotics and more. As a result, 
quorum can now be used to teach 
programming in high schools and colleges 
like. The aim of this paper is to allow 
students to program Arduino boards using 
this language along with learning the 
fundamentals of programming. This would 
result in adding a new application area to 
quorum. Our system transpiles (converts) 
user submitted quorum code into logically 
equivalent Arduino code. It incorporates a 
total of three web services developed 
using NodeJS and Tornado, deployed 
separately as containerized applications 
over Heroku. Apart from this, MongoDB 
and Firebase Cloud Storage are used for 
storing user details and files respectively. 
This with 


asynchronous system 


design allows us an 


and scalable 
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entirely on cloud. Thus users can program 
Arduino boards using Quorum right in their 


browser. 


Keywords: arduino; cloud transpiler; cloud 


compiler; docker; programming; quorum 


language; web-app 


|. INTRODUCTION 


Quorum is an evidence-based 
programming language, mainly designed to be 
accessible by everyone, in particular to 
visually-impaired students. It aims to simplify 
syntax while writing codes. Its applications 
include audio processing, basic game 
development etc. Academic curriculum laid 
out by Quo- rum can be used by teachers to 
teach programming concepts to students. [1] 
[2] As such we believe that the simplicity of 
quorum can be used to teach other 
technologies in collabo- ration while learning 
the language itself. This encouraged us to 
think about various possible areas which can 


be benefited from quorum. 
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Arduino boards are one of the most widely 
used microcontrollers in embedded systems. 
lt offers inherent advantages like being 
inexpensive, supports cross _ platform 
operation, is open-source and has extensible 
software and hardware. All these advantages 
allow Arduino to be used extensively in 
personal and industrial projects. Hence, 
Arduino support for the Quorum programming 


language was decided upon. 


Cloud computing generally means storing 
and accessing data or programs over the 
internet. More specifically delivering computer 
services can be called cloud computing. 
Recent years have seen availability of all 
different types of compilers that are deployed 
online. Such compilers are widely found in 
online programming contests, recruitment 
platforms and learning platforms alike. 
Basically these compilers work by spawning a 
compile command in a certain sandboxed 
environ- ment returning output to the user. 
Different organizations have incorporated 
different architectures for their needs keeping 
in mind the number of users that will be using 
the compiler, available resources, response 
time and many other factors. Deploying 
compilers over cloud increases the range of 
devices through which people can write 
programs while reducing the overhead of 


compiler maintenance. [10] [4] 
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Transpilation is a process of converting a 


code in one high level language to another 
high level language. Eg. Converting a code 
written in Python to Java. This process 
involves converting the original source code 
into some intermediary data structure which 
captures all the essential features of the input 
code followed by conversion of this 
intermediary data structure to target language. 
Abstract Syntax Trees(AST) are widely used 
as intermediary data structures due to their 
small size and easier interpretation than parse 


trees. [8] 


In this paper we present a transpiler for 
converting Quorum into Arduino that functions 
within a browser. In section Il we provide a 
detailed description of all the components that 
make up the system followed by section Ill 
which depicts how these components are 
related and work in cohesion. System 
implementation is elaborated in section IV. 
section V reviews the performance of the 
system and finally we conclude the paper 
along with possible technical implementations 
for increasing the performance and features. 
of section headings, document margins, 
column width, column spacing and other 


features. 
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ll. SYSTEM DESCRIPTION 


A. Quorum Compiler 


The Quorum compiler is packed as a jar file 
that needs to be invoked every time to compile 
a Quorum file. Just like other programming 
language files, quorum files end with 
extension .quorum. Apart from the compiler’s 
jar file, path to the standard library along with 
the user file and custom sensor libraries need 
to be passed in order to compile a quorum file. 

Thus the command to compile looks like: 

java -jar 


Quorum.jar -library 


path/to/standard/libraries - compile 


userfile.quorum LED.quorum IRED.quorum 


Quorum files after userfile.quorum are all 
sensor based libraries written to help quorum 
identify new functions and classes added to 


support arduino. 


B. Quorum to Arduino Transpiler 


The quorum to Arduino transpiler consists of 
4 main files viz. lexer, parser, listener and 
actual transpiler itself with additional handler 
file to facilitate the process of transpilation. 
The lexer reads the quorum files and 
generates a stream of tokens which the parser 
reads to generate a parse tree. Listener 
contains functions that are invoked when 
traversing the parse tree. These functions are 
modified so as to generate another tree that 
stores all the minimal information needed for 
transpilation. The transpiler file then reads this 


newly generated tree and converts them by 
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combining values of the nodes with a 


predefined template of statements. Detailed 
explanation of the transpilation is provided 


below. 


| VARIABLE S 
integer a = 10 i: - > AN 


INTEGER pn ii — 


Token assignment Parse Tree by 
by Lexer Parser 


A line of code 


Fig. 1. Working of Lexer and Parser 


The job of lexer is to identify words in the 
input stream and assign appropriate Tokens to 
them. After assigning tokens, the parser reads 
this sequence of tokens and generates a 
parse tree containing all the information of the 


input line of code. 


Tokens and parser rules are specified in the 
grammar file. ANTLR4 reads this file and 
generates lexer, Parser and other necessary 


files. 


Another important file that is generated is 
the listener. It is used to traverse the parse 
tree. While traversing the parse tree, a new 
tree is generated which serves as an 
intermediate data structure for code 
conversion. This new tree captures only 
essential information and is more compact 


than a parse tree. 
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| ine | | ine | 
Tae] ome ie 
| =) | Data Type = "integer | => int a = 10; 


variable ="a" 
Parse Tree by SSS | 


Substitutions for 
Parser 


child nodes are 
checked through 
the rules to 
generate final 
converted code 


variable value = 10 | 


Converting Parse Tree into 
Intermediate Data Structure 


Fig. 2. Conversion of Parse Tree into 


Transpiled code 


For each of the syntax, keywords and 
possible statements of quorum, corresponding 
mapping is written in Arduino. The transpiler 
looks up these mappings while reading the 
new tree and applies appropriate substitution 
to all the nodes to generate the converted 


code. 


C. Docker Container 


Containers can be thought of as a package 
which contains the app itself bundled with all 
its dependencies and its execution 
environment. This allows greater portability, 
as these containers can be executed on any 
machine with a Docker engine. Containers are 
lightweight as compared to traditional virtual 
machines and are more secure than VMs due 
to tighter and more sandboxed environments. 
Our docker containers for both compiler and 
transpiler are derived from base ubuntu 
image. With the help of Dockerfile Python, 


Java and other dependencies are installed 
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followed by copying of all the required source 


files while building the image. 


D. Heroku 


Heroku is a Platform-as-a-Service(PaaS) 
cloud service provider. With support for 
multiple languages, a wide range of add-ons, 
ease in deploying and scaling are some of the 
features that make Heroku a top choice 
among organizations and individual 
developers. lts free tier provides all the 
necessary requirements for deploying all our 
apps viz. Ui handler, compiler and transpiler. 
The Ul handler is deployed simply as a 
webapp while the other two are containerized. 

To ease the process of development and 
deployment, both transpiler and compiler are 
part of the same_ production pipeline. 
github 


attached to them and environment variables 


Corresponding repositories are 
are configured separately. Each app runs ona 


standard web dyno. 


Ill. SYSTEM ARCHITECTURE 


The system follows the Client-Server 
architecture and is heavily inspired by the 
designs presented in papers[4] and [5]. Login, 
UI and file storing functionalities are handled 
by the NodeJS server. For Signup and Login, 
user data is updated and fetched from the 
MongoDB database. Post signup/login user is 
presented with a text-editor with certain other 


features that aid him in writing code. After 
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clicking on save, the file is saved to Firebase 
Cloud storage. Afterwards the user can click 
Compile. The NodeJS server then sends a 
request to the compiler server asking for the 
particular file to be compiled. The compile 
server downloads the file and compiles it. 
Results are sent back to the user. Similarly, 
after clicking Transpile, a request is made to 
the transpile server. It downloads and 
proceeds to transpilation. Errors if any or 
converted code are then sent back to calling 
NodeJS server. Both the compile and transpile 
servers delete the file on completion of the 
request. All the communication between the 


servers takes place in JSON. 











Fig. 3. System Diagram 


IV. IMPLEMENTATION 


A. User Interface 


User interface consists of a general purpose 
text editor. An option to upload files is also 
provided. Before saving it is mandatory that 
the user sets the name of the file without any 


extension. Finally at the bottom there is a 
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result area which shows errors or converted 


code accordingly. 


B. Quorum Compiler 


For each compile request a new subprocess 
is spawned. The terminal output of this 
process is checked and formatted to be sent 
back to the user. Sensitive information if any is 
removed from the response. If the compilation 
process is successful the compiler outputs 
Build Successful, else a list of errors along 


with line number and description is displayed. 


C. Quorum Transpiler 


Unlike the compiler, the transpiler is 
designed to only send results. If any errors are 
encountered they are simply ignored. This 
may lead to erroneous output. But the 
possibilities of errors arising during 
transpilation are quite low, since the compiler 
has already checked the files. 

All the quorum files need to follow the below 
structure for successful and correct 
compilation. 

e Names of sensor libraries that will be 
used followed by class declaration 

e Inside the class begins with 

instantiation of libraries that will be used 

e Proceed with action Main() and 

configure pins using respective sensor 


methods. 
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e End the method and class with 


keyboard “end” 


Consider the below code snippet as an 


example. 


Use BUTTON 
class MyClass 
BUTTON btn 
action Main() 
btn : pinBTN(12) 
integer a = btn 
STATE() 
output a 
end 


end 


It uses the custom Button library. An 
instance of button is connected at pin 12, and 
its value is read into integer a. 

For the above provided quorum code, the 
transpiler generates the following Intermediate 


Tree: 


AnyNode(nodename='const_root' ) 


= AnyNode(value=12, var='btn') 


AnyNode(nodename='setup_root') 
= AnyNode(functype='INPUT', ins_name='btn', lib='BUTTON') 
AnyNode(nodename='loop_root') 


AnyNode(dtype='integer', funs='STATE()', lib_ist='btn', nodename=' 





Fig. 4. Intermediate Tree Data Structure 


Above figure has three different trees 
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e Tree that holds all constant values 


e Tree that holds setup part 
e Tree that holds loop part 

The Constant tree has one node, which 
means in the input code one variable was 
identified which could be made a constant in 
arduino code. That variable has a value of 12 
and its name is “btn”. 

In the Setup tree there is a node which 
makes use of the library “Button”. Instance 
associated with it is “btn” and serves as an 
“input” to the arduino. 

Similarly in the Loop tree there are 2 
important nodes. The last two nodes represent 
end keyword mark end of Main function and 
class respectively. The first node is named as 
“dNa” which in code means Declaration and 
Assignment. Furthermore this node tells that 
there is a variable named ‘a’ of integer 
datatype who is assigned a value which is 
returned from a function named STATE, 
associated with instance btn. Second node 
has its name set to output which tells it to print 
out a value. Variable that needs to be printed 
iS a. 

Internally, different types of node names are 
assigned as per various syntax available in 
quorum. Each line is represented as a node 
and different nodes hold different properties as 
per their needs. These nodename properties 
assigned to nodes help in identifying 
appropriate Quorum-to-Arduino statements. 


The statements are like templates in which the 
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transpiler finds and fills values from input complexity which involved all types of 
code. syntaxes which the transpiler is able to convert 
For the mentioned quorum code, the were used as input. The graphs have file 
transpiler produced following output: number on x-axis and time taken for 
const int btn = 12 compilation/transpilation of that file on y-axis. 
void setup () { Dyno provided by Heroku for both these 
\toin Mode( btn , INPUT ) ; apps is Free type and is allocated a total of 
\tSerial.begin( 9600 ) ; 512MB of RAM and CPU share of 1x each. 
void loop () { The Dyno sleeps after 30 minutes of inactivity. 
\tint a = digitalRead ( btn ) ; Time taken to restart the dyno after it has been 
\ t Serial. printin( a ) ; asleep is not considered here. 
} 
TABLE | 
The transpiler prepends tabs according to SUMMARY OF INPUT FILES 


the level of blocks. When using conditionals, [Libraries | 
the block level is increased by one, hence the , = om E 
number of tabs are incremented by 1 as Used ed 

compared to the previous line. When moving afes. 

out of conditionals the block level is decreased Pa fo 

and the number of tabs decremented by one. 
For- matting code on transpiler side, reduces 


overhead on UI side. Hence the result can be 


displayed directly. 


eam 
2 Wed 
2 


Medium 


Advanced 
V. RESULTS AND ANALYSIS Advanced 


For measuring the performance of the | 2 | 4 | Advanced | 


system the compilation and transpilation time 





were measured on a local computer and 
system after it was deployed completely on 


cloud. Fifteen different files of varying 
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Table 1 gives a summary of the input files 
used for benchmarking the system, followed 
by plots. Each of the files was processed 5 
times and corresponding times were noted. 
Average of these 5 times was taken and 
plotted. 

The graphs for average of local and online 
compile time look similar in nature but differ in 
scale. While on the local computer, all files 
were compiled in less than 1 second, the same 
files took more than 6 seconds online. There 
seems to be no clear relation between time for 
compilation and complexity of lines but the 
resources allocated during compilation seem 
to be the factor determining time for 
compilation. 

Similar to the compilation case, the nature of 
graphs for transpilation on local and online 
seem to close. Interestingly the time difference 
between them is also not huge. Thing to note 
is that as the number of lines, libraries and 
complexity of the code increases the time 
taken to transpile increases, which is evident 
from both the graphs. So, alinear relation 
between transpilation time and complexity of 


code exists. 
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Less than 10 lines Less than 20 lines More than 30 lines 
(Basic) (Medium) (Advanced) 


File 1 File 3 File 5 File 7 File 9 File 11 File 13 File 15 


Fig. 5. Average Local Compile Time(in 


seconds) 


Less than 10 lines Less than 20 lines More than 30 lines 


(Basic) (Medium) (Advanced) 





File 1 File 3 File 5 File 7 File 9 File 11 File 13 File 15 


Fig. 6. Average Online Compile Time(in 


seconds) 


Less than 10 lines Less than 20 lines More than 30 lines 


(Basic) (Medium) (Advanced) 





File 1 File 3 File 5 File 7 File 9 File 11 File 13 File 15 


Fig./. Average Local Transpile Time(in 


seconds) 
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Less than 10 lines Less than 20 lines More than 30 lines 


(Basic) (Medium) (Advanced 





File 1 File 3 File 5 File 7 File 9 File 11 File 13 File 15 


Fig. 8. Average Online Transpile Time(in 


seconds) 


The difference in scales of graphs and linear 
relation between transpile time and complexity 
suggests that there are rooms for 
improvement of the system. Following things 
can be further incorporated to do so: 

e Upgrading to better Dyno type on 
Heroku 
e Switching to another Cloud Service 
Provider that provides more resources 
e Making grammar rules more efficient to 
remove redundancies and eliminating 
rules that will never be used 
e Writing the transpiler in some other 
language faster than python 
e Modifying the way in which the 
transpiler is deployed over cloud. Other 
methods of deployment can be studied 


and implemented. 
VI. CONCLUSION AND FUTURE WORK 


We developed the system with an aim to 


bridge the gap between quorum and Arduino 
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by allowing students to program Arduino 


boards. Deploying it over cloud allows 
everyone to access it and can be easily 
incorporated in teaching methodologies. 
Modular separation of storage, Ul handler and 
actual compiler/transpiler allows a system that 
is easily scalable as per requirements. It also 
increases system reliability as any failures in 
the system are localized and contained within 
that module only. The limited flexibility in the 
quorum syntax that we have implemented can 
be increased to support more data types and 
control structures. At the same time transpiler 
efficiency can be increased and libraries to 
be added. 


Responsiveness of the system in case of 


handle other sensors can 
multiple users can be decreased by following 
a more asynchronous approach in which 
multiple operations like file fetching and 
formatting, compiling, etc belonging to 
different requests can be processed parallely. 
Finally cloud security services can be placed 
throughout the system to prevent cloud 


software abuse. 
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